home *** CD-ROM | disk | FTP | other *** search
/ PC World 2008 February / PCWorld_2008-02_cd.bin / v cisle / spambully / spambully.exe / spambully4oe.exe / firebird.conf < prev    next >
Text File  |  2006-03-07  |  20KB  |  650 lines
  1. #######################################
  2. #
  3. # Firebird configuration file
  4. #
  5. # Comments
  6. # --------
  7. # The # character is used for comments and can be placed anywhere on a
  8. # line.  Anything following the # character on a line is considered a
  9. # comment.
  10. #
  11. # Examples:
  12. #
  13. #    # This is a comment
  14. #    DefaultDbCachePages = 2048   # This is an end-of-line comment
  15. #
  16. # Entries
  17. # -------
  18. # The default value for each entry is listed to the right of the "=".
  19. # To activate an entry, remove the leading "#"s and supply the desired
  20. # value.
  21. #
  22. # Please note, a number of the values are specified in **Bytes** (Not KB).
  23. # Accordingly, we have provided some simple conversion tables at the bottom
  24. # of this file.
  25. #
  26. # There are three types of configuration values: integer, boolean and string.
  27. # 
  28. # Integer
  29. # --------
  30. # Integers is what they sound like, an integral value. Examples:
  31. #   1
  32. #   42
  33. #   4711
  34. # 
  35. # Boolean
  36. # -------
  37. # Boolean is expressed as integer values with 0 (zero) being "false" and
  38. # non-zero is taken to mean "true". For consistency we recommend you
  39. # only use 0/1.
  40. # 
  41. # String
  42. # ------
  43. # Strings are also what they sound like, strings. Examples:
  44. #   RootDirectory  = /opt/firebird
  45. #   RemotePipeName = pipe47
  46. #
  47. #
  48. # Portions of this file have been reproduced/made available with the
  49. # permission of Ann Harrison @ IBPhoenix.
  50. #
  51. #######################################
  52.  
  53. # ==================================
  54. # Settings for all platforms/engines
  55. # ==================================
  56. #
  57. # ----------------------------
  58. # Specify the root directory under which Firebird is installed.
  59. # Can be used to override the OS-specifically determined one.
  60. #
  61. # Type: string
  62. #
  63. #RootDirectory = 
  64.  
  65.  
  66. # ----------------------------
  67. # Database Paths/Directories
  68. #
  69. # DatabaseAccess may be None, Full or Restrict. If you choose Restrict, 
  70. # provide ';'-separated trees list, where database files are stored.
  71. # Relative paths are treated relative to RootDirectory entry
  72. # (see above). Default value 'Full' gives full access to all files
  73. # on your site. To specify access to specific trees, enum all required
  74. # paths (for Win32 this may be something like 'C:\DataBase;D:\Mirror', 
  75. # for unix - '/db;/mnt/mirrordb'). If you choose 'None', then only
  76. # databases listed in aliases.conf can be attached.
  77. #
  78. # UNCONTROLLED DATABASE ACCESS MAY COMPROMISE YOUR SYSTEM!
  79. # IT IS STRONGLY RECOMMENDED THAT THIS SETTING BE USED TO LIMIT
  80. # DATABASE LOCATIONS!
  81. #
  82. # Type: string (special format)
  83. #
  84. #DatabaseAccess = Full
  85.  
  86.  
  87. # ----------------------------
  88. # External File Paths/Directories
  89. #
  90. # ExternalFileAccess may be None, Full or Restrict. If you choose 
  91. # Restrict, provide ';'-separated trees list, where external files 
  92. # are stored. Relative paths are treated relative to RootDirectory entry
  93. # (see above). Default value 'None' disables any use of external files
  94. # on your site. To specify access to specific trees, enum all required
  95. # paths (for Win32 this may be something like 'C:\ExternalTables', 
  96. # for unix - '/db/extern;/mnt/extern').
  97. #
  98. # NOTE: THE EXTERNAL TABLE ENGINE FEATURE COULD BE USED TO COMPROMISE
  99. # THE SERVER/HOST AS WELL AS DATABASE SECURITY!!
  100. #
  101. # IT IS STRONGLY RECOMMENDED THAT THIS SETTING BE USED TO LIMIT
  102. # EXTERNAL TABLE LOCATIONS!
  103. #
  104. # Type: string (special format)
  105. #
  106. #ExternalFileAccess = None
  107.  
  108.  
  109. # ----------------------------
  110. # External Function (UDF) Paths/Directories
  111. #
  112. # UdfAccess may be None, Full or Restrict. If you choose 
  113. # Restrict, provide ';'-separated trees list, where UDF libraries
  114. # are stored. Relative paths are treated relative to RootDirectory entry
  115. # (see above). Default value 'Restrict UDF' provides the same restrictions
  116. # as in FB 1.0. To specify access to specific trees, enum all required
  117. # paths (for Win32 this may be something like 'C:\ExternalFunctions', 
  118. # for unix - '/db/extern;/mnt/extern').
  119. #
  120. # NOTE: THE EXTERNAL FUNCTION ENGINE FEATURE COULD BE USED TO COMPROMISE
  121. # THE SERVER/HOST AS WELL AS DATABASE SECURITY!!
  122. #
  123. # IT IS STRONGLY RECOMMENDED THAT THIS SETTING BE USED TO LIMIT
  124. # EXTERNAL FUNCTION LOCATIONS! SPECIALLY AVOID HAVING 
  125. # COMMON SUBTREES IN UdfAccess & ExternalFileAccess !
  126. #
  127. # Type: string (special format)
  128. #
  129. #UdfAccess = Restrict UDF
  130.  
  131.  
  132. # ----------------------------
  133. # Temporary directories
  134. #
  135. # Provide ';'-separated trees list, where temporary files are stored.
  136. # Relative paths are treated relative to RootDirectory entry
  137. # (see above). Default value is determined using FIREBIRD_TMP,
  138. # TEMP or TMP environment options. Every directory item may have optional
  139. # size argument to limit its storage, this argument follows the directory
  140. # name and must be separated by at least one space character. If the size
  141. # argument is omitted or invalid, then all available space in this
  142. # directory will be used.
  143. #
  144. # E.g.:
  145. # TempDirectories = c:\temp
  146. # or
  147. # TempDirectories = c:\temp;d:\temp
  148. # or
  149. # TempDirectories = c:\temp 100000000;d:\temp 500000000;e:\temp
  150. #
  151. # Type: string (special format)
  152. #
  153. #TempDirectories =
  154.  
  155.  
  156. # ----------------------------
  157. # Number of cached database pages
  158. #
  159. # This sets the number of pages from any one database that can be held
  160. # in cache at once. If you increase this value, the engine will
  161. # allocate more pages to the cache for every database. By default, the
  162. # SuperServer allocates 2048 pages for each database and the classic
  163. # allocates 75 pages per client connection per database.
  164. #
  165. # Type: integer
  166. #
  167. #DefaultDbCachePages = 2048
  168.  
  169.  
  170. # ----------------------------
  171. # In-memory sorting module
  172. #
  173. # The amount of memory allocated for each sort block.
  174. #
  175. # Type: integer
  176. #
  177. #SortMemBlockSize = 1048576
  178.  
  179. #
  180. # The maximum amount of memory to be allocated by the in-memory
  181. # sorting module.
  182. #
  183. # For Classic servers, this setting is defaulted to 8 MB.
  184. # Although it can be increased, the value applies to each client
  185. # connection/server instance and thus consumes a lot of memory.
  186. #
  187. # Type: integer
  188. #
  189. #SortMemUpperLimit = 67108864
  190.  
  191.  
  192. # ----------------------------
  193. # Backward-compatible parameter ordering as it was in FB v1/IB
  194. #
  195. # Type: boolean
  196. #
  197. #OldParameterOrdering = 0
  198.  
  199.  
  200. # ----------------------------
  201. # Boolean evaluation method (complete or shortcut)
  202. #
  203. # If your SQL code depends on side-effects of full evaluation of OR
  204. # and AND statements (right-hand-side terms), even if the expressions
  205. # final result could be determined by just examining the value of the
  206. # first term, you might need to turn this on.
  207. #
  208. # Type: boolean
  209. #
  210. #CompleteBooleanEvaluation = 0
  211.  
  212.  
  213. # ----------------------------
  214. # 
  215. # Determines the number of seconds that the lock manager will wait after a
  216. # conflict has been encountered before purging locks from dead processes 
  217. # and doing extra deadlock scan cycle. Engine detects deadlocks instantly 
  218. # in all normal cases, so this value affects things only if something goes
  219. # wrong. Setting it too low may degrade system performance. 
  220. #
  221. # Type: integer
  222. #
  223. #DeadlockTimeout = 10
  224.  
  225.  
  226. # ----------------------------
  227. #
  228. # How often the pages are flushed on disk
  229. # (for databases with ForcedWrites=Off only)
  230. #
  231. # Number of unflushed writes which will accumulate before they are
  232. # flushed, at the next transaction commit.  For non-Win32 ports,
  233. # the default value is -1 (Disabled)
  234. #
  235. # Type: integer
  236. #
  237. #MaxUnflushedWrites = 100
  238.  
  239. #
  240. # Number of seconds during which unflushed writes will accumulate
  241. # before they are flushed, at the next transaction commit. For non-Win32
  242. # ports, the default value is -1 (Disabled)
  243. #
  244. # Type: integer
  245. #
  246. #MaxUnflushedWriteTime = 5
  247.  
  248.  
  249. # ----------------------------
  250. #
  251. # This option controls whether to call abort() when internal error or BUGCHECK
  252. # is encountered thus invoke post-mortem debugger which can dump core suitable 
  253. # for off-line analysis. When disabled engine tries to minimize damage and 
  254. # continue execution. 
  255. #
  256. # Note that setting this option to 1 makes engine produce traceable coredumps 
  257. # when something nasty like SIGSEGV happens inside UDF. On Windows enabling 
  258. # this option makes engine invoke JIT debugger facilities when errors happen.
  259. #
  260. # Type: boolean
  261. #
  262. #BugcheckAbort = 0
  263.  
  264.  
  265. # ----------------------------
  266. #
  267. # Prior to Firebird 1.5 various SELECT expressions generated unnamed 
  268. # columns. This did not conform to the SQL standard. Fb 1.5 saw the 
  269. # introduction of default aliases for these unnamed columns. In some 
  270. # cases, particularly if string concatenation is used (via the || 
  271. # operator) this breaks existing scripts. 
  272. # 
  273. # This setting will affect aliases generated via CONCATENATION, 
  274. # CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP and EXTRACT. Setting 
  275. # the value to true will disable the alias generation. It is only 
  276. # recommended to be used where legacy scripts need to be supported.
  277. # It will be marked deprecated in Firebird 2.0 and removed in 
  278. # Firebird 3.0.
  279. #
  280. # Type: boolean
  281. #
  282. #OldColumnNaming = 0
  283.  
  284.  
  285. # ----------------------------
  286. # Client Connection Settings (Basic)
  287. #
  288. # Seconds to wait before concluding an attempt to connect has failed.
  289. #
  290. # Type: integer
  291. #
  292. #ConnectionTimeout = 180
  293.  
  294. #
  295. # Seconds to wait on a silent client connection before the server sends
  296. # dummy packets to request acknowledgment.
  297. #
  298. # DO NOT USE THIS OPTION. It may hang or crash Windows on the client side as 
  299. # explained here: http://support.microsoft.com/default.aspx?kbid=296265
  300. # or may not prevent eventual inactive client disconnection for other OS.
  301. #
  302. # Normally, Firebird uses SO_KEEPALIVE socket option to keep track of 
  303. # active connections. If you do not like default 2-hour keepalive timeout
  304. # then adjust your server OS settings appropriately. On UNIX-like OS's, 
  305. # modify contents of /proc/sys/net/ipv4/tcp_keepalive_*. On Windows, 
  306. # follow instrutions of this article:
  307. # http://support.microsoft.com/default.aspx?kbid=140325
  308. #
  309. # Type: integer
  310. #
  311. #DummyPacketInterval = 0
  312.  
  313.  
  314. # ----------------------------
  315. # TCP Protocol Settings
  316. #
  317. # The TCP Service name/Port number to be used for client database
  318. # connections. 
  319. #
  320. # It is only necessary to change one of the entries, not both.  The
  321. # order of precendence is the 'RemoteServiceName' (if an entry is
  322. # found in the 'services.' file) then the 'RemoteServicePort'.
  323. #
  324. # Type: string, integer
  325. #
  326. #RemoteServiceName = gds_db
  327. #RemoteServicePort = 3050
  328.  
  329. #
  330. # The TCP Port Number to be used for server Event Notification
  331. # messages.  The value of 0 (Zero) means that the server will choose
  332. # a port number randomly.
  333. #
  334. # Type: integer
  335. #
  336. #RemoteAuxPort = 0
  337.  
  338. #
  339. # TCP/IP buffer size for send and receive buffers of both the client
  340. # and server. The engine reads ahead of the client and can send 
  341. # several rows of data in a single packet. The larger the packet size,
  342. # the more data is sent per transfer. Range is 1448 to 32768.
  343. #
  344. # Type: integer
  345. #
  346. #TcpRemoteBufferSize = 8192
  347.  
  348. #
  349. # Either enables or disables Nagle algorithm (TCP_NODELAY option of
  350. # socket) of the socket connection.
  351. #
  352. # Note: Currently this is only active for super server, classic
  353. # server needs an extra wrapper program.
  354. #
  355. # Type: boolean
  356. #
  357. #TcpNoNagle = 0
  358.  
  359. #
  360. # Allows incoming connections to be bound to the IP address of a
  361. # specific network card. It enables rejection of incoming connections
  362. # through any other network interface except this one. By default,
  363. # connections from any available network interface are allowed.
  364. #
  365. # Type: string
  366. #
  367. #RemoteBindAddress = 
  368.  
  369.  
  370. # ----------------------------
  371. # Locking and shared memory parameters
  372. #
  373. # Bytes of shared memory allocated for lock manager. 
  374. # In Classic mode, the size given is used for the initial allocation. The
  375. # table expands dynamically up to the limit of memory. In SuperServer, the
  376. # initial size is also the final size.
  377. # Default is 96K on Linux and Solaris, 256K on Windows.
  378. #
  379. # Type: integer
  380. #
  381. #LockMemSize = 262144
  382.  
  383. #
  384. # Number of semaphores for interprocess communication.
  385. # In non-threading environments, this sets the number of semaphores
  386. # available
  387. #
  388. # Type: integer
  389. #
  390. #LockSemCount = 32
  391.  
  392. #
  393. # When a connection wants to lock an object, it gets a lock request 
  394. # block which specifies the object and the lock level requested. Eack
  395. # locked object has a lock block. Request blocks are connected to those
  396. # lock blocks either as requests that have been granted, or as pending
  397. # requests. 
  398. #
  399. # The settings:
  400. #     1 means locks are granted first come, first served.
  401. #    0 means emulate InterBase v3.3 behavior, where locks are granted 
  402. #      as soon as they are available; can result in lock request
  403. #       starvation.
  404. #
  405. # Type: integer/boolean
  406. #
  407. #LockGrantOrder = 1
  408.  
  409. #
  410. # In Classic, only one client process may access the lock table at any
  411. # time. Access to the lock table is governed by a mutex. The mutex can
  412. # be requested conditionally - a wait is a failure and the request must
  413. # be retried - or unconditionally - the request will wait until it is
  414. # satisfied. This parameter establishes the number of attempts that
  415. # will be made conditionally. Zero value means unconditional mode.
  416. # Relevant only on SMP machines.
  417. #
  418. # Type: integer
  419. #
  420. #LockAcquireSpins = 0
  421.  
  422. #
  423. # Tune lock hash list; more hash slots mean shorter hash chains. Only
  424. # necessary under very high load. Prime number values are recommended.
  425. #
  426. # Type: integer
  427. #
  428. #LockHashSlots = 101
  429.  
  430. # ----------------------------
  431. #
  432. # Bytes of shared memory allocated for event manager.
  433. #
  434. # Type: integer
  435. #
  436. #EventMemSize = 65536
  437.  
  438.  
  439. # ===========================
  440. # SuperServer Engine Settings
  441. # ===========================
  442. #
  443. # ----------------------------
  444. # Which CPUs should be used (Windows Only)
  445. #
  446. # In an SMP system, sets which processors can be used by the server.  
  447. # The value is taken from a bit map in which each bit represents a CPU.
  448. # Thus, to use only the first processor, the value is 1. To use both
  449. # CPU 1 and CPU 2, the value is 3. To use CPU 2 and CPU 3, the value
  450. # is 6. The default value is 1.
  451. #
  452. # Type: integer
  453. #
  454. #CpuAffinityMask = 1
  455.  
  456.  
  457. # ----------------------------
  458. # Settings for the thread scheduler (Windows Only)
  459. #
  460. # The wait time, in milli-seconds (ms), before the priority of:
  461. #    - an inactive thread is reduced to 'Low', or 
  462. #    - an active thread is increased to 'High'
  463. #
  464. # Note: The default value was chosen based on experiments on Intel 
  465. # PIII/P4 processors.  It should be increased for using in the computer
  466. # with lower speed processors.
  467. #
  468. # Type: integer
  469. #
  470. #PrioritySwitchDelay = 100
  471.  
  472. #
  473. # Number of cycles of the scheduler (PrioritySwitchDelay ms) before
  474. # thread are destroyed/closed.  Rather than immediately destroy/closed
  475. # worker threads (which would require a semaphore and blocking call --
  476. # significant overhead), the thread scheduler maintains a pool of the
  477. # threads.  When a thread has completed it's task/work, it is marked as
  478. # idle.  The idle thread is destroyed/closed after X iterations of the
  479. # scheduler loop.
  480. #
  481. # For a server with a very large number of connections (presumably more
  482. # than several hundred) the setting value should be increased. 
  483. #
  484. # The setting represents the number of loop iterations to be made before
  485. # the thread is destroyed/closed.
  486. #
  487. # Type: integer
  488. #
  489. #DeadThreadsCollection = 50
  490.  
  491. #
  492. # Number of additional 'intervals' given to a 'High' priority thread.
  493. #
  494. # Type: integer
  495. #
  496. #PriorityBoost = 5
  497.  
  498.  
  499. # ==============================
  500. # Classic Server Engine Settings
  501. # ==============================
  502. #
  503.  
  504.  
  505. # ==============================
  506. # Settings for Windows platforms
  507. # ==============================
  508. #
  509. # ----------------------------
  510. # Does the guardian restart the server every time it crashes?
  511. #    0 - only start the engine/service once
  512. #    1 - always restart the engine/service if it terminates
  513. #
  514. # Type: integer/boolean
  515. #
  516. #GuardianOption = 1
  517.  
  518.  
  519. #
  520. # ----------------------------
  521. # Priority level/class for the server process.
  522. #
  523. # The values are:
  524. #     0 (Zero) - normal priority,
  525. #     positive value - high priority (same as -B command line option)
  526. #     negative value - low priority.
  527. #
  528. # Note: All changes to this value should be carefully tested to ensure
  529. # that engine is more responsive to requests.
  530. #
  531. # Type: integer
  532. #
  533. #ProcessPriorityLevel = 0
  534.  
  535.  
  536. # ----------------------------
  537. # Local Connection Settings
  538. #
  539. # Size in bytes of one client's portion of the memory mapped file used
  540. # for local connections.
  541. #
  542. # Type: integer
  543. #
  544. #IpcMapSize= 4096
  545.  
  546. #
  547. # The name of the shared memory area used as a transport channel in local protocol.
  548. # The default value is not compatible with IB/FB1. Use value 'InterBaseIPI' to
  549. # restore compatibility, if necessary.
  550. #
  551. # Type: string
  552. #
  553. #IpcName = FirebirdIPI
  554.  
  555. #
  556. # The name of the pipe used as a transport channel in NetBEUI protocol.
  557. # Has the same meaning as a port number for TCP/IP. The default value is
  558. # compatible with IB/FB1.
  559. #
  560. # Type: string
  561. #
  562. #RemotePipeName = interbas
  563.  
  564. # 
  565. # Does the server need to create a (hidden) window used for IPC communication.
  566. # Turn this off to run the server without a window and hence without local protocol.
  567. # Can be used for running a few instances of the server simultaneously on win32.
  568. #
  569. # Type: boolean
  570. #
  571. #CreateInternalWindow = 1
  572.  
  573.  
  574. # ============================
  575. # Settings for Unix/Linux platforms
  576. # ============================
  577. #
  578. #
  579. # UNIX signal to use for interprocess communication 
  580. #
  581. # Type: integer
  582. #
  583. #LockSignal = 16
  584.  
  585.  
  586. # ----------------------------
  587. # Remove protection against opening databases on NFS mounted volumes 
  588. # 
  589. #     ***WARNING*** ***WARNING*** ***WARNING*** ***WARNING*** 
  590. #
  591. # This option removes an important safety feature of Firebird and can 
  592. # cause irrecoverable database corruption. Do not use this option unless 
  593. # you understand the risks and are prepared to accept the loss of the 
  594. # contents of your database.
  595. # Unless this configuration option is changed from 0 to 1, Firebird can 
  596. # open a database only if the database is stored on a drive physically 
  597. # attached to the local computer û the computer running that copy of 
  598. # Firebird. Requests for connections to databases stored on NFS mounted 
  599. # drives are redirected to a Firebird server running on the computer that 
  600. # "owns" the disk. 
  601. # This restriction prevents two different copies of Firebird from opening 
  602. # the same database without coordinating their activities. Uncoordinated 
  603. # access by multiple copies of Firebird will corrupt a database. On a local 
  604. # system, the system-level file locking prevents uncoordinated access to 
  605. # the database file.  
  606. # NFS does not provide a reliable way to detect multiple users of a file on 
  607. # an NFS mounted disk. If a second copy of Firebird connects to a database on 
  608. # an NFS mounted disk, it will corrupt the database.
  609. # Under some circumstances, running a Firebird server on the computer that 
  610. # owns NFS mounted volumes is inconvenient or impossible. Applications that 
  611. # use the "embedded" variant of Firebird and never share access to a database 
  612. # can use this option to permit direct access to databases on NFS mounted 
  613. # volumes.   
  614. # DO NOT ENABLE THIS OPTION UNLESS YOU REALLY KNOW WHAT YOU ARE DOING.
  615. #
  616. # Type: boolean 
  617. #
  618. #RemoteFileOpenAbility = 0 
  619.  
  620.  
  621. #######################################
  622. #
  623. # KB to Bytes Conversion table
  624. #
  625. #######################################
  626. #
  627. #    KB     Bytes         KB     Bytes
  628. #   ----    ---------    ----    ---------
  629. #      1    1024           32    32768
  630. #      2    2048           64    65536 
  631. #      4    4096          128    131072
  632. #      8    8192          256    262144  
  633. #     16    16384         512    524288
  634. #
  635. #######################################
  636. #
  637. # MB to Bytes Conversion table
  638. #
  639. #######################################
  640. #
  641. #    MB    Bytes           MB    Bytes            MB    Bytes
  642. #   ---    ---------      ---    -----------     ---    -----------
  643. #     1    1048576         64    67108864        448    469762048
  644. #     2    2097152        128    134217728       512    536870912
  645. #     4    4194304        192    201326592       640    671088640
  646. #     8    8388608        256    268435456       768    805306368
  647. #    16    16777216       320    335544320       896    939524096
  648. #    32    33554432       384    402653184      1024    1073741824
  649. #
  650.